home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / lyap.1 < prev    next >
Text File  |  1995-07-25  |  11KB  |  265 lines
  1.  
  2.  
  3.  
  4.      LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           lyap - display an array of Lyapunov exponents graphically
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           _l_y_a_p [-BLps][-W width][-H height][-o filename][-a _n ] [-b _n
  13.                   ] [-w _n ] [-h _n ] [-i xstart] [-M _n ] [-R _p ] [-S _n
  14.                   ] [-D _n ] [-F string][-f string][-r _n ] [-O _n ] [-C
  15.                   _n ] [-c _n ] [-m _n ] [-x xpos] [-y ypos]
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           _l_y_a_p generates and graphically displays an array of Lyapunov
  19.           exponents for a variety of iterated periodically forced
  20.           non-linear maps of the unit interval.
  21.  
  22.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  23.           -C _n    Specifies the minimum color index to be used for
  24.                   negative exponents
  25.  
  26.           -D _n    Specifies the "dwell" or number of iterations over
  27.                   which to average in order to calculate the Lyapunov
  28.                   exponent. Default is 400.
  29.  
  30.           -H _n    Specifies the height of the window. Default is 256.
  31.  
  32.           -L      Indicates use log(x) + log(y) rather than log(xy).
  33.  
  34.           -M _r    Specifies the real value to compare exponent values
  35.                   to for indexing into a color wheel. The default
  36.                   value is 1.0.
  37.  
  38.           -O _n    Specifies the minimum color index to be used for
  39.                   positive exponents
  40.  
  41.           -R _p    Specifies pseudo-random forcing with probability _p
  42.                   of using parameter value 'a'.
  43.  
  44.           -S _n    Specifies the "settle" or number of iterations prior
  45.                   to the beginning of the calculation of the Lyapunov
  46.                   exponent. Default is 200.
  47.  
  48.           -W _n    Specifies the width of the window. Default is 256.
  49.  
  50.           -a _r    Specifies the real value to use as the minimum
  51.                   parameter value of the horizontal axis. Default is
  52.                   3.0 for the logistic map.
  53.  
  54.           -b _n    Specifies the real value to use as the minimum
  55.                   parameter value of the vertical axis. Default is 3.0
  56.                   for the logistic map.
  57.  
  58.           -c _n    Selects one of six different color wheels to use.
  59.                   The default color wheel is a rainbow palette.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/25/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))
  71.  
  72.  
  73.  
  74.           -F _1_0_1_0_1_0_1_0
  75.                   Specifies the "Function" forcing function to use.
  76.                   The example above would alternate between iterating
  77.                   the circle and logistic maps. An argument of "-F
  78.                   2323" would alternate between left and right
  79.                   logistic maps. The default is to only use the single
  80.                   specified map (see the description of -m).
  81.  
  82.           -f _a_b_b_a_b_a_a_b
  83.                   Specifies the forcing function to use. The default
  84.                   is to alternate between the "a" parameter and the
  85.                   "b" parameter.
  86.  
  87.           -h _r    Specifies the real value to be used as the range
  88.                   over which the vertical parameter values vary. The
  89.                   default is 1.0.
  90.  
  91.           -i _r    Specifies the real value of the initial condition to
  92.                   use. Default is 0.05.
  93.  
  94.           -m _n    Selects between available non-linear maps of the
  95.                   unit interval. A value of 0 specifies the logistic
  96.                   map. A value of 1, the circle map. A value of 2, the
  97.                   left-logistic. A value of 3, the right-logistic. A
  98.                   value of 4, the double-logistic. The default is 0,
  99.                   the logistic map.
  100.  
  101.           -o _f_i_l_e_n_a_m_e
  102.                   Specifies the output filename to be used. If the -o
  103.                   option is given, this file will automatically be
  104.                   written out at the completion of the drawing.  If it
  105.                   is not specified, a default filename of lyap.out is
  106.                   used and only written if the 'F' key is pressed
  107.                   during a run. The format of the output file is PPM
  108.                   for color and PGM for monochrome. The parameters
  109.                   used to calculate the picture are included as
  110.                   comments at the beginning of the file.
  111.  
  112.           -p      Switches color indices for negative and positive
  113.                   exponents. Generally, causes negative exponents to
  114.                   be displayed in more detail while darkening and
  115.                   narrowing the color range for positive exponents.
  116.                   This can be toggled during runtime by pressing the
  117.                   'p' key.
  118.  
  119.           -r _n    Specifies the maximum rgb value to be used. Default
  120.                   is 35000.
  121.  
  122.           -s _f_i_l_e_n_a_m_e
  123.                   Specifies the output filename to be used when saving
  124.                   for a later restart. If the -s option is given, this
  125.                   file will automatically be written out at the
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/25/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))
  137.  
  138.  
  139.  
  140.                   completion of the drawing. If it is not specified, a
  141.                   default filename of lyap.sav is used and only
  142.                   written if the 'f' key is pressed during a run. The
  143.                   color indices are saved for picture restoration. The
  144.                   parameters and other variables necessary to resume
  145.                   calculation are stored as well. You can therefore
  146.                   use the -s option or 'f' key to temporarily save the
  147.                   program's state and resume at a later time.
  148.  
  149.           -u      Produces a usage message.
  150.  
  151.           -v      Prints out the various values to be used and exits.
  152.  
  153.           -w _r    Specifies the real value to be used as the range
  154.                   over which the horizontal parameter values vary. The
  155.                   default is 1.0.
  156.  
  157.           -x _n    Specifies the x screen coordinate of the window
  158.                   (default is 256).
  159.  
  160.           -y _n    Specifies the y screen coordinate of the window
  161.                   (default is 256).
  162.  
  163.  
  164.  
  165.      NNNNOOOOTTTTEEEESSSS
  166.           During display, pressing any mouse button allows you to
  167.           select the area to be investigated with the mouse. The upper
  168.           left hand corner of the desired area is the location of the
  169.           cursor when the button is pressed. The lower right hand
  170.           corner is specified by the cursor when the button is
  171.           released.
  172.  
  173.  
  174.           Use of the keys _d_D_e_E_f_F_k_K_j_J_m_n_r_R_s_S_u_U_w_W_x_X_q_Q indicates:
  175.  
  176.                (<) Halve dwell value.
  177.                (>) Double dwell value.
  178.                ([) Halve settle value.
  179.                (]) Double settle value.
  180.                (d) Descends the ladder of lyap windows if a ladder has
  181.           previously been ascended via the 'u' or 'U' keys.
  182.                (D) Flushes the drawing buffer
  183.                (E or e) Recalculate the indices into the color wheel
  184.           using a different method
  185.                (f) Save current screen to lyap format ouput file for
  186.           later continuation
  187.                (F) Save current screen to PPM format ouput file for
  188.           later redisplay
  189.                (H or h or ?) Display brief help message
  190.                (i) Decrement the interval between stripes for the
  191.           striped color map.
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/25/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               LLLLYYYYAAAAPPPP((((LLLLOOOOCCCCAAAALLLL))))
  203.  
  204.  
  205.  
  206.                (I) Increment the interval between stripes for the
  207.           striped color map.
  208.                (K) Decrease value exponents are compared against by
  209.           0.05.
  210.                (J) Increase value exponents are compared against by
  211.           0.05.
  212.                (M) Decrease value exponents are compared against by
  213.           0.005.
  214.                (N) Increase value exponents are compared against by
  215.           0.005.
  216.                (m) Increment the map index, changing the map to be
  217.           iterated.
  218.                (P or p) Toggle positive/negative exponent display.
  219.                (r) Redraw the window using previously calculated
  220.           exponents.
  221.                (R) Redraw the window using the newly set dwell and/or
  222.           settle values.
  223.                (S) Spin the color wheel
  224.                (s) Halve the length of the spin and spin the color
  225.           wheel
  226.                (u) Go up to the window just prior to the most recent
  227.           zoom.
  228.                (U) Go all the way up to the original window.
  229.                (V or v) Display values of various parameters currently
  230.           in use
  231.                (W or w) Use next color map.
  232.                (<ctrl>-W) Use color map in $HOME/.lyapmap
  233.                (X or x) Clear window
  234.                (Q or q) quit
  235.  
  236.  
  237.  
  238.      AAAAUUUUTTTTHHHHOOOORRRR
  239.                   Ronald Joe Record
  240.                The Santa Cruz Operation
  241.                     P.O. Box 1900
  242.                  Santa Cruz, CA 95061
  243.                       rr@sco.com
  244.  
  245.  
  246.  
  247.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
  248.           The algorithm was taken from the September 1991 Scientific
  249.           American article by A. K. Dewdney who gives credit to Mario
  250.           Markus of the Max Planck Institute for its creation.
  251.           Additional information and ideas were gleaned from the
  252.           discussion on alt.fractals involving Stephen Hall, Ed
  253.           Kubaitis, Dave Platt and Baback Moghaddam. Assistance with
  254.           colormaps and spinning color wheels and X was gleaned from
  255.           Hiram Clawson. Rubber banding code was adapted from an
  256.           existing Mandelbrot program written by Stacey Campbell.
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 7/25/95)
  262.  
  263.  
  264.  
  265.